home *** CD-ROM | disk | FTP | other *** search
/ FM Towns: Free Software Collection 9 / FM Towns Free Software Collection 9.iso / t_os / tool / sdkpoket / sdkpockt.doc < prev    next >
Encoding:
Text File  |  1994-11-16  |  8.1 KB  |  214 lines
  1. ０.----作者覚書----
  2. ; ** MEMO ************************************* TAB=8 ***
  3. ; * ｻｲﾄﾞﾜｰｸ対応 SDKﾎﾟｹｯﾄ        Ver1.00C    *
  4. ; * for FM-TOWNS/Towns MENU/T-BIOS V2.1 L20～        *
  5. ; *     初版 1994/06/09        XX.X版 9999/99/99    *
  6. ; ********************************************** ToY ****
  7.  
  8. [ｿﾌﾄｳｪｱ名    ] ｻｲﾄﾞﾜｰｸ対応 ﾎﾟｹｯﾄ入出力ﾌﾟﾛｸﾞﾗﾑ "SDKﾎﾟｹｯﾄ" Ver1.00C
  9. [ﾌﾟﾛｸﾞﾗﾑ名   ] SDKPOCKT.EXP
  10. [作者        ] ToY
  11. [使用可能機種] FM-TOWNSｼﾘｰｽﾞ + ﾏｳｽ必須
  12.                TownsOS v2.1 L20以降 ﾎﾟｹｯﾄ機能必須
  13.                16/256/32768色以外の画面モードでは起動しません｡
  14. [動作確認    ] FM-TOWNS ME20(RAM 10M,HDD 340M)
  15.                TOWNS-OS v2.1 L20(ﾌﾘｺﾚ7版CD起動)/L31(HDD起動)で確認
  16. [開発機種    ] FM-TOWNS ME20
  17. [開発言語    ] High-Cｺﾝﾊﾟｲﾗ v1.7 + 拡張ﾗｲﾌﾞﾗﾘI(v2.1L20)
  18. [著作権表示他] COPY_R.DOCをご覧ください
  19.  
  20.  
  21. １.----概要----
  22.       当ｿﾌﾄｳｪｱは､TownsOSv2.1L20からｻﾎﾟｰﾄされたﾎﾟｹｯﾄ領域の入出力を行う
  23.     物です｡ﾎﾟｹｯﾄ領域と通常ﾌｧｲﾙの間で内容のやり取りを行う事が出来ます｡
  24.       例えば､ｾｰﾌﾞ機能の無い体験版ｿﾌﾄのﾎﾟｹｯﾄ機能を使用してﾃﾞｰﾀを保存す
  25.     るという､極悪非道な使用法が有ります｡
  26.       TownsPAINT IIお試し版とか(^^; ｢6.2章参照｣
  27.  
  28.  
  29. ２.----使用方法----
  30.  
  31.   2.1 初期準備
  32.       当ｿﾌﾄｳｪｱはﾎﾟｹｯﾄ領域を対象としていますので､ｼｽﾃﾑ設定でﾎﾟｹｯﾄを"使用
  33.     する"にしておいて下さい｡
  34.  
  35.  
  36.   2.2 起動方法
  37.       以下の起動方法が有ります｡
  38.  
  39.     (1) ｻｲﾄﾞﾜｰｸに登録する｡
  40.     (2) ｱｲﾃﾑ登録する｡ (種別はｱﾌﾟﾘｹｰｼｮﾝ/TownsOS/ﾃﾞｨﾚｸﾄﾘ移動なし､です)
  41.     (3) TownsMENU上でﾌｧｲﾙをﾀﾞﾌﾞﾙｸﾘｯｸする｡
  42.       (ｻｲﾄﾞﾜｰｸ/ｱｲﾃﾑ登録の方法はTownsMENUﾃﾞｨｸｼｮﾅﾘを見てください)
  43.  
  44.  
  45.   2.3 ﾌｧｲﾙ格納先指定
  46.       ﾌｧｲﾙの入出力先を指定する必要が有ります｡以下の2通りの方法が有り
  47.     ます｡
  48.  
  49.     (1) ﾊﾟﾗﾒｰﾀに指定する｡
  50.       ｻｲﾄﾞﾜｰｸ/ｱｲﾃﾑ登録時､ﾊﾟﾗﾒｰﾀにﾃﾞｨﾚｸﾄﾘﾊﾟｽを記述する｡
  51.     <例>
  52.       D:\WORK\        ←DﾄﾞﾗｲﾌﾞのWORKﾃﾞｨﾚｸﾄﾘに保存
  53.       D:\WORK\DATA    ←DﾄﾞﾗｲﾌﾞのWORKﾃﾞｨﾚｸﾄﾘにDATAと言うﾌｧｲﾙ名で保存
  54.     <注>
  55.       ﾃﾞｨﾚｸﾄﾘを指定した場合､ﾌｧｲﾙ名は自動的にSCBDATAになります｡ﾌｧｲﾙ名
  56.     も指定する場合は"."や拡張子は指定しないでください｡
  57.  
  58.     (2) 環境変数SCBに設定
  59.       ﾊﾟﾗﾒｰﾀが記述されてない場合､ﾎﾟｹｯﾄ機能が使用する環境変数SCBで設定
  60.     されているﾃﾞｨﾚｸﾄﾘが格納先になります｡ﾌｧｲﾙ名は自動的にSCBDATAになり
  61.     ます｡環境変数を使用する場合は､最後に"\"を付ける必要は有りません｡
  62.     <例>
  63.       ･DOSｺﾝｿｰﾙで環境変数SCBを設定する場合
  64.       SET SCB=D:\SCB  ←DﾄﾞﾗｲﾌﾞのSCBﾃﾞｨﾚｸﾄﾘに設定する｡
  65.       ･環境変数を確認するには､DOSｺﾝｿｰﾙで SET と入力すると表示されます｡
  66.     <注>
  67.       ｼｽﾃﾑ設定でﾎﾟｹｯﾄ領域の"退避先ﾊﾟｽ"が指定されている場合は､TownsOS起
  68.     動時にそのﾊﾟｽが環境変数SCBにｾｯﾄされます｡(HDD使用時のみ)
  69.  
  70.  
  71. ３.----使用方法----
  72.      ﾏｳｽの左ﾎﾞﾀﾝのみ使用します｡下図の[1],[4],[5]をｸﾘｯｸ出来ます｡
  73.  
  74.     +------------------+
  75.     |[1]        [  2  ]|
  76.     |[     3       ][4]|  ←SDKﾎﾟｹｯﾄだと思って下さい｡
  77.     |             [ 5 ]|
  78.     +------------------+
  79.  
  80.     [1] 終了ﾎﾞﾀﾝ   SDKﾎﾟｹｯﾄを終了します｡
  81.     [2] 内容表示   現在ポケット内にあるデータの種別を表示します｡
  82.     [3] ﾒｯｾｰｼﾞ表示 各種ﾒｯｾｰｼﾞがでます｡
  83.     [4] 処理選択   処理を選択します｡以下の処理が選択できます｡
  84.         "ﾎﾟｹｯﾄ→FILE "        ﾎﾟｹｯﾄ内容をﾌｧｲﾙに出力｡(ﾎﾟｹｯﾄｱｳﾄ)
  85.         "  XXX→ﾎﾟｹｯﾄ"        ﾌｧｲﾙをﾎﾟｹｯﾄに書き込む｡(ﾎﾟｹｯﾄｲﾝ)
  86.         "ﾎﾟｹｯﾄ ｸﾘｱ   "        ﾎﾟｹｯﾄ領域のｸﾘｱ｡
  87.     [5] 実行ﾎﾞﾀﾝ   選択した処理を実行します｡
  88.     その他の場所でﾏｳｽﾎﾞﾀﾝ押すと､SDKﾎﾟｹｯﾄを移動する事が出来ます｡
  89.  
  90.     <注> "XXX→ﾎﾟｹｯﾄ"の処理は転送元ﾌｧｲﾙを2.3章で指定したﾃﾞｨﾚｸﾄﾘにSCBD
  91.          ATA.XXXの名前で複写しておく必要が有ります｡(SCBDATAはﾌｧｲﾙ名未
  92.          設定時｡XXXは下記参照)
  93.     <注> "ﾎﾟｹｯﾄ→FILE"の処理では､ﾌｧｲﾙを上書きしますので､古いﾌｧｲﾙの内容
  94.          は失われます｡保存する場合は､別の場所に複写しておいてください｡
  95.  
  96.       処理が終了すると､"正常終了"のﾒｯｾｰｼﾞが出ます｡処理を続行する場合
  97.     は[4]を再度ｸﾘｯｸしてください｡
  98.  
  99.  
  100.   ----拡張子 (XXX)----
  101.       ﾎﾟｹｯﾄに書き込むﾌｧｲﾙは以下の拡張子を付けて下さい｡"ﾎﾟｹｯﾄ→FILE"の
  102.     処理時は自動的に以下の拡張子が付きます｡
  103.  
  104.     +-----------------------+------+
  105.     | ポケットの内容        |拡張子|
  106.     +-----------------------+------+
  107.     | ASCII文字列(ﾃｷｽﾄ)     | TXT  |
  108.     | TIFF形式画像ﾃﾞｰﾀ      | TIF  |
  109.     | Towns Drawﾃﾞｰﾀ        | DRW  |
  110.     | Towns PCMﾃﾞｰﾀ         | SND  |
  111.     | Towns MIDIﾃﾞｰﾀ        | EUP  |
  112.     | 動画ﾃﾞｰﾀ              | MVE  |
  113.     | MS RIFF DIB           | DIB  |
  114.     | MS Waveformｵｰﾃﾞｨｵﾃﾞｰﾀ | WAV  |
  115.     | MS RIFF MIDI          | MID  |
  116.     | MS Windowsﾑｰﾋﾞｰﾌｧｲﾙ   | MMM  |
  117.     | ﾕｰｻﾞｰ定義ﾎﾟｹｯﾄﾃﾞｰﾀ    | USR  |
  118.     +-----------------------+------+
  119.     MSはﾏｲｸﾛｿﾌﾄの略号｡
  120.     DRW/MIDは正しくない?誰か正しい拡張子を知りませんか?
  121.  
  122.  
  123. ４.----ｴﾗｰ ﾒｯｾｰｼﾞ ----
  124.     "ﾎﾟｹｯﾄOPEN Err" ･ｼｽﾃﾑ設定でﾎﾟｹｯﾄを設定していない｡
  125.                     ･他ﾌﾟﾛｸﾞﾗﾑがﾎﾟｹｯﾄを専有している｡
  126.     "ﾊﾟﾗﾒｰﾀ Err   " ･ﾃﾞｨﾚｸﾄﾘの指定がない｡
  127.                     ･環境変数SCBがない｡
  128.     "FILE OPEN Err" ･ﾃﾞｨﾚｸﾄﾘの指定が誤っている｡
  129.                     ･XXX→ﾎﾟｹｯﾄで元のﾌｧｲﾙが存在しない｡
  130.                     ･ﾌｧｲﾙがｵｰﾌﾟﾝ出来ない｡(書込み禁止など)
  131.                <注> ﾎﾟｹｯﾄにﾃﾞｰﾀを格納する場合､指定のﾃﾞｨﾚｸﾄﾘに元のﾌｧｲﾙ
  132.                     が必要｡(3章<注>参照)
  133.                <例> TIFFをﾎﾟｹｯﾄに入れる場合､SCBDATA.TIF(ﾌｧｲﾙ名未設定時)
  134.                     と言う名前で2.3章で指定したﾃﾞｨﾚｸﾄﾘに複写しておく｡
  135.     "ﾎﾟｹｯﾄI/O Err " ･ﾎﾟｹｯﾄの領域が不足｡(HDDが無い場合はﾎﾟｹｯﾄ機能はﾒﾓﾘ
  136.                      上だけで機能する為､注意が必要)
  137.                     ･ﾎﾟｹｯﾄ入出力ｴﾗｰ｡
  138.     "DISK I/O Err " ･出力先の空き領域が不足｡
  139.                     ･ﾌｧｲﾙ入出力ｴﾗｰ｡
  140.  
  141.  
  142. ５.----注意事項----
  143.     ･ｻｲﾄﾞﾜｰｸとして使用する場合はｻｲﾄﾞﾜｰｸ領域180K(標準ｻｲｽﾞ)で起動できま
  144.      す｡
  145.     ･16/256/32768色以外の画面ﾓｰﾄﾞでは起動しません｡(16,777,216色では起
  146.      動しない)
  147.     ･ﾎﾟｹｯﾄの内容は電源を切ったり､ﾘｾｯﾄすると失われます｡
  148.     ･ﾌｧｲﾙの入出力はｻｲｽﾞのみﾁｪｯｸしています｡媒体不良やﾌｧｲﾙ異常はﾁｪｯｸし
  149.      ていません｡
  150.     ･処理中は停止出来ません｡処理が終了するまで､待っていてください｡ﾘｾｯ
  151.      ﾄするとﾃﾞｨｽｸのﾁｪｲﾝ情報(ﾌｧｲﾙの格納場所などを記録している情報)が壊
  152.      れるかもしれませんよ｡(私は壊した事があります｡MS-DOSのCHKDSKｺﾏﾝﾄﾞ
  153.      で確認できます｡)
  154.  
  155.  
  156. ６.----おまけ----
  157.  
  158. 6.1 作成経緯
  159.     ･5月下旬｡体験版ｿﾌﾄで遊ぶ｡TownsPAIINT2が気に入ったが､当然ｾｰﾌﾞ機能
  160.      が削除されている｡が､ﾎﾟｹｯﾄ機能が生きていたので､ﾎﾟｹｯﾄ←→Fileの簡
  161.      易ｿﾌﾄをHigh-Cで記述する｡
  162.     ･5月末日｡ｻｲﾄﾞﾜｰｸにすれば､PAINT2を終了しないで､ﾎﾟｹｯﾄ←→Fileができ
  163.      るかな?と思い､ｻｲﾄﾞﾜｰｸ対応にするが､TownsPAINT2はﾎﾟｹｯﾄ領域を専有し
  164.      ていたので､うまく動かず｡仕方ないので､終了してﾎﾟｹｯﾄの入出力をする｡
  165.     ･6月1週｡ｱｯﾌﾟしようと思ったが､汎用性なし!画面なし!では情けないので､
  166.      ちゃんとしたﾌﾟﾛｸﾞﾗﾑに変更する｡(このﾌﾟﾛｸﾞﾗﾑです｡)
  167.     ･と､言うことで､使い道が"TownsPAINT IIお試し版"専用?ですが､普通の人
  168.      は､こんなソフト作らないでしょう? v(^^)v
  169.  
  170. 6.2 TownsPAINT II体験版での使用方法(あぁ､非道)
  171.     1)現ﾎﾟｹｯﾄﾗｲﾌﾞﾗﾘではﾎﾟｹｯﾄ領域に1種類のﾃﾞｰﾀしか入りませんので､ﾍﾟｲﾝﾄﾚ
  172.       ｲﾔや複数のﾄﾞﾛｳﾚｲﾔにあるﾃﾞｰﾀを1つのﾚｲﾔに複写する｡全図形選択後､ﾎﾟｹ
  173.       ｯﾄｲﾝする｡
  174.     2)TownsPAINT IIを終了する｡
  175.     3)当ｿﾌﾄでﾎﾟｹｯﾄﾃﾞｰﾀをﾌｧｲﾙに移し､保存の必要があれば別のﾌｧｲﾙに複写して
  176.       おく｡
  177.     4)TownsPAINT IIでﾛｰﾄﾞする場合は､PAINT II起動前に当ｿﾌﾄで3)のﾃﾞｰﾀをﾎﾟ
  178.       ｹｯﾄに入れておき､PAINT II起動後ﾎﾟｹｯﾄｱｳﾄする｡
  179.  
  180.     ･注意1｡PAINT II体験版では大量のﾃﾞｰﾀをﾎﾟｹｯﾄｲﾝすると､なぜか時間が掛
  181.      かります｡特にﾄﾞﾛｳﾃﾞｰﾀ曲線は少ないほうがいいでしょう｡(下手すると30
  182.      分以上ﾎﾟｹｯﾄｲﾝの処理をしています｡最初は暴走している!!と思った程です)
  183.     ･注意2｡ﾄﾞﾛｳﾃﾞｰﾀをﾎﾟｹｯﾄｲﾝした場合ﾊﾟﾚｯﾄﾃﾞｰﾀは格納されないので､ｽｸﾘｰﾝｶｯ
  184.      ﾀｰやﾊｰﾄﾞｺﾋﾟｰ(ﾌｧｲﾙ)で別途TIFFﾌｧｲﾙを保存しておいた方がいいでしょう｡
  185.      PAINT II起動後､"ﾌｧｲﾙ"→"開く"を行えばﾊﾟﾚｯﾄが設定されます｡
  186.  
  187.       その他の体験版ソフトではﾎﾟｹｯﾄが使えないか､使い物にならないの､ど
  188.     ちらかです｡TownsGraphとByHANDはﾎﾟｹｯﾄ機能が使えますが､対象がﾃｷｽﾄだ
  189.     けですので使い物になりません｡F-BASIC 386はﾎﾟｹｯﾄ機能が使用できない
  190.     ように変更してありました｡(体験版CD & TonwsMagazineで確認)
  191.  
  192. 6.3 図説
  193.       ﾎﾟｹｯﾄ機能とSDKﾎﾟｹｯﾄの概要を図示するので参考にしてください｡
  194.     
  195.      +-------------+        +-------------+
  196.      |  ｱﾌﾟﾘｹｰｼｮﾝA |        |  ｱﾌﾟﾘｹｰｼｮﾝB |
  197.      +-------------+        +-------------+
  198.                ﾎﾟｹｯﾄｲﾝ    ﾎﾟｹｯﾄｱｳﾄ    +-----------+
  199.                  ↓          ↑       | ﾎﾟｹｯﾄ領域 |(RAMに入らない時
  200.                 +--------------+      |   (RAM)   | は､RAMとHDDに分
  201.                 |   Towns OS   |      + - - - - - + 割保存する｡
  202.                 | (Towns BIOS) |←--→|           | ﾌｧｲﾙ名はSCB.DAT)
  203.                 +--------------+ ﾃﾞｰﾀ |   (HDD)   |
  204.                  ↑↓                 +-----------+
  205.               ﾎﾟｹｯﾄｲﾝ/ｱｳﾄ
  206.                 +----------+          +-------------+
  207.                 | SDKﾎﾟｹｯﾄ | ←----→ | ﾌｧｲﾙ        |
  208.                 +----------+ ﾌｧｲﾙ I/O | SCBDATA.XXX |
  209.                                       +-------------+
  210.  
  211.  
  212.  1994/6/10 by NHE_T.Y            ----以上----
  213.  
  214.